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iillllllililillttlllllllilllllllilll 
II Main ad scheduler 
ScheduleMain 

{ 

// Has a new day dawned? 

Do CheckForNewDay 

// Are we within the current ad's showFor? 

if ( ad.thisShowTime < ad.showFor ) 

{ 

// there is nothing to be done 
return 

} 

// At this point, we know that we need a new ad 

// Perform housekeeping tasks on the old one 

do AdEndBookkeeping 

// Pop out of a block if all ads on par 

if ( block isn't all playlists ) 

{ 

find ad with minimum ad.numberShown 
if ( ad.numberShown >= blockGoal ) 
set block to all playlists 

// If we are over our quota of regular ads for the day, 
// look for a runout 

if ( adFaceTimeToday > faceTimeQuota ) 

{ 

do ShowARunout 
else 

{ 

Do ShowARegularAd 

> 
} 

// end ad schedule main 
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llllllilllllllllllllllliillllllillll 

II We must perform certain tasks when the calander day 
changes. 

CheckForNewDay 

{if ( the calander day has changed ) 

{ 

// Perform housekeeping tasks on the ad currently showing 
Do StopShowingCurrentAd 

// Runout ads are charged for a full showFor if they've been 
shown 

// at all on a given day. Charge any runout ads if they've 
been 

// shown at all. 
for runout ads 

{ 

if ( ad.thisShowTime > 0 ) 

{ 

ad.totalTimeShown += ad.showFor 
ad.thisShowTime = 0 

// Now, reset the counters for all ads to reflect the fact 
that 

// a new day has dawned, 
for all ads 

{ 

ad.numberShownToday = 0 

} 

// Record yesterday's facetime 

// Might not literally be yesterday, be sure to use 

// whatever day the app was last run on 

set old current day's facetime to totalFaceTimeToday 

// and reset our global regular ad facetime counter 

adFaceTimeToday = 0 

totalFaceTimeToday = 0 

// if we were in a block, back out 

set block to all playlists 

// end CheckForNewDay 
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//////////////////////////////////// 

// This function shows a runout ad, and if it 

// can't find one, goes to a rerun 

ShowARunout 

{ 

for runout ads 

{ 

// has the ad been flushed? 
if ( ad.flushed ) 
try next ad 

// are we done showing this runout today? 

if ( ad.numberShownToday > ad.dayMax ) 

try next ad // this one's used up for the day 

// are we done showing this runout for ever and ever? 

if ( ad.shownFor > ad.shownForMax ) 

try next runout ad // this one's used up forever 

// are we between the ad's start and end date? 

if ( ad.startDate < the current date < ad.endDate ) 

try next runout ad 

// the ad is not supposed to run today 
// do we actually HAVE the ad? 
if ( ad has not been downloaded ) 

{ 

ask for ad to be downloaded 
try next ad 

} 

// ok, we believe we should show this runout 
// we are now in runout state 
Do ShowAnAd 
return 

} 

// if we haven't found a runout ad, we will go to "rerun" 
state 

Do ShowARerun 
// end ShowARunout 
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llllllllllllllllllllllllllllllllllll 

II Rerun state. Look for a regular ad to rerun 

ShowARerun 

{ 

for regular ads [ in current block ] 

{ 

// has the ad been flushed? 
if ( ad. flushed ) 
try next ad 

// is this ad recent enough to rerun? 

if ( ad.lastShownDate is older than returnlnterval ) 

try next ad 

// this one is too old to rerun 
// if in block, show ads only if it's their "turn" 
if ( ad.numberShownToday >= blockGoal ) 
try next ad // need to find a friend in this block 
// are we between the ad's start and end dates? 
if ( ad.startDate < the current date < ad.endDate ) 
try next ad 

// the ad is not supposed to run today 
// do we actually HAVE the ad? 
if ( ad has not been downloaded ) 

{ 

ask for ad to be downloaded 
try next ad 

} 

// ok, at this point we can show this ad, but because 
// we're in rerun, we don't keep the books 
Do ShowAnAd 
return 

} 

// if we get here, we have no ads to show. Punt, 
return 

} 

// end ShowARerun 
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llllilllllllltllllllllllllllltlllltl 
II Show a regular ad 
ShowARegularAd 

{ 

for regular ads [ in current block ] 

{ 

// has the ad been flushed? 
if ( ad.flushed) 
try next ad 

// are we done showing this ad today? 
if (ad.numberShownToday > ad.dayMax ) 
try next ad // this one's used up for the day 
// if in block, show ads only if it's their "turn" 
if ( ad.numberShownToday >= blockGoal ) 
try next add // need to find a friend in this block 
// are we done showing this ad for ever and ever? 
if ( ad.shownFor > ad.showForMax ) 
try next ad // this one's used up forever 
// are we between the ad's start and end dates? 
if ( ad.startDate < the current date < ad.endDate ) 
try next ad 

// the ad is not supposed to run today 
// do we actually HAVE the ad? 
if ( ad has not been downloaded ) 

{ 

ask for ad to be downloaded 
try next ad 

} 

// ok, we believe we should show this ad 
// we are now in regular state 
Do ShowAnAd 
return 

} 

// if we get here, we have failed to find a regular 
// ad. Go to runout 
Do ShowARunout 

} 

// end ShowARegularAd 



FIG. 15E 



29/42 



I/i/IIIIIIIIIIIII/IllllllltIIIIIIIII 

II Perform necessary housekeeping when we're taking 

// down an ad 

AdEndBookkeeping 

{ 

// In rerun state, we don't do any bookkeeping 

if ( in RerunState ) 

return 

// Account for at most ad.showFor seconds, provided 
// we've shown the ad for at least ad.showFor seconds 
// Note that this means we don't charge for time beyond 
// ad.showFor seconds, which is important 
if ( ad.thisShowTime >= ad.showFor ) 

{ 

ad.numberShownToday += ad.showFor 
ad.shownFor-M- 

// we do NOT reset thisShowTime here, we do it in 
// AdStartBookkeeping. It actually doesn't matter where 
// we do it, provided we are careful NOT to do it for 
// runout ads. 

// end AdEndBookkeeping 
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IIIIIIIIIIIIIIIIIIIIIIIIIIIIII/IUII 

II Show an ad, including bookkeeping and block handling 
ShowAnAd 

{ 

// If the ad is in a block, notice that 
if ( it's in a "block" playlist ) 

{ 

if ( not currently in a block ) 

{ 

pj find ad in block with minimum numberShown 

E3 make that our ad 

?2 set blockGoal to minimum numberShown+1 

M> } 

set current block to this playlist 

3 > 

fy // now do bookkeeping 

03 Do AdStartBookkeeping 

// and actually show it 
Do Display ThatAd 

} 
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lllllllllllllllllllllllllllllllllllll 

II Perform housekeeping when we put up an ad 

AdStartBookkeeping 

{ 

// In return state, we don't do any bookkeeping 

if ( in RerunState ) 

return 

// For regular ads 
if ( it's a regular ad ) 

{ 

ad.thisShowTime = 0 
ad.lastShownDate = now 

> 

// end AdStartBookkeeping 
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